home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 034a / wwmail1.zip / WWIVMAIL.DOC < prev    next >
Text File  |  1991-12-11  |  15KB  |  523 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.        WWIVMail 1
  31.  
  32.        Documentation
  33.  
  34.  
  35.  
  36.  
  37.     ** Contents
  38.  
  39.          1 Copyrights
  40.          1 Legal Notice and Disclaimer
  41.          1 Technical Requirements
  42.  
  43.          2 Installation
  44.          2     WWIV Considerations
  45.          2     FrontDoor Considerations
  46.          2     FrontDoor Setup
  47.          3     FrontDoor control file
  48.  
  49.          3 Command Line Options
  50.          3     IN, OUT, CHECK
  51.          3         WWIVMail IN
  52.          3         WWIVMail OUT
  53.          3         WWIVMail CHECK
  54.          3     FC - Flow Control
  55.          3     LOG - FrontDoor Log
  56.          4     HIS - FrontDoor History Files
  57.          4     Sample FrontDoor control file
  58.  
  59.          4 Modem Considerations
  60.  
  61.          5 Error Conditions
  62.  
  63.          5 Advanced Configurations
  64.  
  65.          6 Future Enhancements
  66.  
  67.          6 Inquiries and Registration
  68.          6     Inquiries
  69.          6     Registration
  70.          7     Reaching the Author
  71.  
  72.          7 Technical Information
  73.  
  74.          7 Credits
  75.  
  76.  
  77.  
  78.     ** Copyrights
  79.  
  80.        WWIVMail and WWIVMail Documentation
  81.        (C) 1991 Andrew J. Mead
  82.        All Rights Reserved.
  83.  
  84.        FrontDoor
  85.        (C) 1986-1991 Advanced Engineering sarl
  86.        All Rights Reserved.
  87.  
  88.        WWIV version 4 and WWIV Network software
  89.        (C) 1988-1991 Wayne Bell
  90.        All Rights Reserved.
  91.  
  92.  
  93.  
  94.     ** Legal Notice and Disclaimer        
  95.  
  96.        WWIVMail is provided as is.  In no event will the author be liable
  97.        for any damages, costs, or lost mail resulting from the use of
  98.        WWIVMail
  99.  
  100.        WWIVMail is to be freely distributed.  It may be used free of charge
  101.        in non-commercial settings.  Commercial liscences are available upon
  102.        request.
  103.  
  104.  
  105.  
  106.     ** Technical Requirements
  107.  
  108.        WWIVMail is designed to help SysOps install WWIV Network software
  109.        underneath FrontDoor.
  110.  
  111.        This program was written and debugged with the following programs:
  112.  
  113.            FrontDoor 2.02/NC
  114.            WWIV 4.20A
  115.            WWIV Network 27
  116.  
  117.        If your system can run this software than it should have no problem
  118.        with WWIVMail.
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.                                          1
  139.  
  140.  
  141.  
  142.     ** Installation
  143.  
  144.        WWIV Considerations
  145.  
  146.            You will need to place WWIVMAIL.EXE in your main WWIV directory.
  147.            This is the directory that contains BBS.EXE and NETWORK.EXE.
  148.            If you have modified the structure of CONFIG.DAT, this software
  149.            may not work properly.  WWIV itself is not necessary, only some
  150.            its data files are.
  151.  
  152.            WWIVMail uses the following WWIV files
  153.                required
  154.                  CONFIG.DAT
  155.                  NETWORK.EXE NETWORK1.EXE NETWORK2.EXE NETWORK3.EXE
  156.                  BBSDATA.NET BBSLIST.NET  CALLOUT.NET  CONNECT.NET
  157.  
  158.                required for HIS option (described later)
  159.                  NET.LOG
  160.  
  161.                used if present
  162.                  REGIONS.DAT
  163.  
  164.  
  165.        FrontDoor Considerations
  166.  
  167.            WWIVMail uses the following FrontDoor files
  168.                required
  169.                  SETUP.FD
  170.  
  171.                required for HIS option (described later)
  172.                  INBOUND.HIS   (with IN option)
  173.                  OUTBOUND.HIS  (with OUT option)
  174.                  LASTCALL.FD
  175.  
  176.                written to by LOG option (described later)
  177.                  log file from FDSetup "Filenames" submenu
  178.  
  179.  
  180.        FrontDoor Setup
  181.  
  182.            In the Mailer menu in FDSetup goto the Miscellaneous submenu.
  183.            Under the selection  "BBS Software Name" you will need to
  184.            enter "NN: " (without the quotes).  When a remote WWIVnet
  185.            mailer calls your system and sees the "NN: " string it will
  186.            respond with its mailer identification string "!-@NETWORK@-!".
  187.  
  188.            In the Mailer menu in FDSetup goto the External Mail submenu.
  189.            You will need to enter the string "!-@NETWORK@-!" with the
  190.            errorlevel you will want to initiate the WWIVMail processing.
  191.            Once FrontDoor receives the mailer id string it will immediately
  192.            exit with the chosen errorlevel, bypassing the normal 11 second
  193.            or more wait.
  194.  
  195.            Note: Both the "NN: " and the "!-@NETWORK@-!" strings may be
  196.            changed using the macro feature of WWIVnet mailer software.
  197.            A limited discussion of this is in the Advanced Configurations
  198.            section.
  199.  
  200.  
  201.  
  202.                                          2
  203.  
  204.  
  205.  
  206.            In the Mailer menu in FDSetup go to the Errorlevels submenu.
  207.            You will need to turn the "Create .BAT File" option on.
  208.            WWIVMail uses this file to create command line arguments for
  209.            running the WWIV Network programs.
  210.  
  211.  
  212.        FrontDoor control file
  213.  
  214.            In your FrontDoor control file (usually a batch file that
  215.            runs FrontDoor, and branches execution based on errorlevels
  216.            that FrontDoor exits with) you will need to have the
  217.            following things happen when FrontDoor exits (with the
  218.            errorlevel indicated in the External Mail submenu).
  219.  
  220.                change active directory to main WWIV directory
  221.                execute WWIVMAIL with the necessary argument(s)
  222.  
  223.  
  224.  
  225.     ** Command Line Options
  226.  
  227.            IN, OUT, CHECK
  228.                One of these three options must be present (otherwise
  229.                the help screen appears).  These options tell WWIVMail
  230.                what mode to operate in.
  231.  
  232.                WWIVMail IN
  233.                  This tells WWIVMail that another WWIV Network Mailer
  234.                  has just connected, and a connection needs to be
  235.                  established.   (NETWORK.EXE needs to be run)
  236.  
  237.                WWIVMail OUT
  238.                  This option, which is not yet operational, tells WWIVMail
  239.                  to poll another system.
  240.  
  241.                WWIVMail CHECK
  242.                  This option, which can be run without all of the normally
  243.                  required system files present, is the diagnostic option.
  244.                  It merely checks for unprocessed mailbags, processes them.
  245.                  If the Network files are not properly updated, it will
  246.                  process them as well.  This option will ignore both
  247.                  the FC and HIS options.
  248.  
  249.  
  250.            FC - Flow Control
  251.                If you are using a modem with a locked terminal-modem
  252.                communication rate, you will want to add this switch
  253.                to the command line.
  254.  
  255.  
  256.            LOG - FrontDoor Log
  257.                This option will have WWIVMail log its activity in your
  258.                FrontDoor log.
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.                                          3
  267.  
  268.  
  269.  
  270.            HIS - FrontDoor History Files
  271.                This option will log incoming and outgoing calls in
  272.                FrontDoor's INBOUND.HIS and OUTBOUND.HIS files.
  273.                It will update LASTCALL.FD as well.
  274.                It will not update the activity records.
  275.                The following translations are made
  276.                  Zone      : 9948  (WWIV on your telephone keypad)
  277.                  Net       : WWIV Network group number from BBSDATA.NET
  278.                  Node      : WWIV Network node number from NET.LOG
  279.                  System    : System name from BBSDATA.NET
  280.                  Location  : derived from REGIONS.DAT based on area
  281.                              code in BBSDATA.NET
  282.                  Sent/Rcvd : rounded up to next 1k increment.  Derived
  283.                              from NET.LOG
  284.  
  285.  
  286.            Sample from the authors FrontDoor control file
  287.                :FRONTDOOR
  288.                If ERRORLEVEL 91 Goto WWIVMAILIN  ; incomming WWIV mail
  289.                REM -----------------------------
  290.                :WWIVMAILIN                       ;  91 WWIVMail ***
  291.                ChDir C:\WWIVDIR                  ; change to WWIV directory
  292.                wwivmail in log his
  293.                Goto FRONTDOOR                    ; return to FrontDoor
  294.                REM -----------------------------
  295.  
  296.  
  297.  
  298.     ** Modem Considerations
  299.  
  300.        WWIV Network Software needs to be told about the connection.
  301.        WWIVMail understands the following connect string arguments
  302.            Asynchronious argument
  303.              HST
  304.            Error Correction arguments
  305.              LAPM
  306.              ARQ
  307.              REL
  308.            Data Compression arguments
  309.              V42BIS
  310.              MNP5
  311.  
  312.        If your modem sends result codes that don't match the above
  313.        list, PLEASE let me know what they are so I may include them
  314.        in a later version of WWIVMail.
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.                                          4
  331.  
  332.  
  333.  
  334.     ** Error Conditions
  335.  
  336.        If no errors are encounted, WWVIMail will exit with no
  337.        errorlevel.
  338.  
  339.        If the program crashes, it will exit with its Turbo Pascal
  340.        generated errorlevel.
  341.  
  342.        The following errorlevels are generated by WWIVMail if it
  343.        determines it can't proceed.
  344.  
  345.            231 : -- More than one main command parameter [IN,OUT,CHECK]
  346.                     was selected.
  347.            232 : -- WWIV's "CONFIG.DAT" not found.
  348.            233 : -- FD's "DOBBS.BAT" not found.
  349.            234 : -- WWIV's "BBSLIST.NET" not found.
  350.            235 : -- WWIV's "BBSDATA.NET" not found.
  351.            236 : -- WWIV's "CALLOUT.NET" not found.
  352.            237 : -- WWIV's "CONNECT.NET" not found.
  353.            238 : -- FD's "SETUP.FD" not found.
  354.            239 : -- FD's "INBOUND.HIS" not found.
  355.            240 : -- FD's "OUTBOUND.HIS" not found.
  356.            241 : -- WWIV's "NET.LOG" not found.
  357.            242 : -- Error extracting numeric value from WWIV''s "NET.LOG".
  358.            243 : -- WWIV node number not found in "BBSDATA.NET".
  359.            255 : -- Feature not available.
  360.  
  361.  
  362.  
  363.     ** Advanced Configurations
  364.  
  365.        By using the macro features of the WWIV Network software, you
  366.        can easily configure multiple WWIV Network nodes under one
  367.        FrontDoor node.  This can simplify running both WWIVnet and
  368.        WWIVlink on the same system (for example).  All you need to
  369.        do is coordinate with the systems you connect to, and change
  370.        the Network ID string from !-@NETWORK@-! to some other string.
  371.        Using different strings with different networks keeps the
  372.        confusion to a minimum.
  373.        You will also need to create entries in your FrontDoor External
  374.        Mail submenu that reflect these changes.
  375.  
  376.        You can also use macros to change the 'NN: ' string to something
  377.        more pleasing.
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.                                          5
  395.  
  396.  
  397.  
  398.     ** Future Enhancements
  399.  
  400.        The next version of WWIVMail should implement the OUT command
  401.        line directive.  You will be able to add external events to
  402.        your FrontDoor Event Manager that will have WWIVMail poll other
  403.        systems.
  404.  
  405.        I would also like add support for VirtualNet (VBBS) or write a
  406.        seperate but similiar utility.  However, I need to obtain certain
  407.        technical information about VBBS network software first.
  408.  
  409.        I am also looking for someone who writes real technical
  410.        documentation to help prepare future versions of this documention.
  411.  
  412.  
  413.  
  414.     ** Inquiries and Registration
  415.  
  416.        Inquiries
  417.            The latest version of WWIVMail is available for immediate
  418.            download or FREQ from the author.
  419.  
  420.            The Infinite Improbability BBS
  421.            @9952 WWIVnet
  422.            1:151/205 FidoNet (Private Idaho BBS)
  423.            (919) 489-9446 (Durham, NC - PCPursuit NCRPT)
  424.  
  425.            The BBS currently operates on an old USRobotics Courier 2400e
  426.            at 2400 bps with MNP-3.  (As of December 1991)
  427.  
  428.            The filename will follow the form WWMAILn.ZIP where "n"
  429.            is the latest version number.
  430.  
  431.  
  432.        Registration
  433.            WWIVMail may be freely used in non-commercial environments.
  434.            However, I still ask that you register the software.  If
  435.            you are merely registering (no money) then please just fill
  436.            out the form in the file REGISTER.FRM and E-Mail it, File
  437.            Attach it, or postal mail it to me.
  438.  
  439.            For commericial installations please contact me for further
  440.            information.
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.                                          6
  459.  
  460.  
  461.  
  462.        Reaching the author
  463.            FidoNet
  464.              Andrew J. Mead 1:151/205 (Private Idaho BBS)
  465.              Andrew Mead 1:151/205 (Private Idaho BBS)
  466.            WWIVnet
  467.              Doc Technical 1@9952 (The Infinite Improbability BBS)
  468.              Andrew J. Mead 2@9952 (The Infinite Improbability BBS)
  469.            Direct Dial
  470.              (919) 489-9446 (2400bps - Durham, NC - PCPursuit NCRPT)
  471.            Postal Mail
  472.              Andrew J. Mead
  473.              WWIVMail
  474.              PO BOX 1155
  475.              Chapel Hill, NC 27514-1155
  476.  
  477.  
  478.  
  479.     ** Technical Information
  480.  
  481.        WWIVMail is written in Turbo Pascal, and compiled in either
  482.        Turbo Pascal 5.5 or Turbo Pascal 6.0 (depending on which
  483.        computer I was last on).  WWIVMail does not use any direct
  484.        screen activity, and should be compatible with DESQview and
  485.        other multi-taskers.
  486.  
  487.        Source code licenses are available, please see the enclosed
  488.        REGISTER.FRM file.
  489.  
  490.  
  491.  
  492.     ** Credits
  493.  
  494.        I would like to thank Dennis O'Dell (Plain Brown Wrapper) for
  495.        prodding me on this program (all 4 days it took to write) as
  496.        well as helping me test it and suggesting most of the options.
  497.        Dennis can be thanked, bothered, or complained to at
  498.            FidoNet
  499.              Dennis O'Dell 1:151/204 Another World BBS
  500.            WWIVnet
  501.              Plain Brown Wrapper #1@9968 Another World BBS
  502.            or directly dialed in the US at
  503.              (919) 220-6299 (2400bps - Durham, North Carolina)
  504.  
  505.        (I would also like to thank Mollie and Rob for putting up with
  506.        my phone calls and helping when Dennis was not there)
  507.  
  508.        Finally, I would like to thank
  509.            Joaquim H. Homrighausen and Advanced Engineering sarl for
  510.            FrontDoor.
  511.                                       and
  512.            Wayne Bell for WWIV and WWIV Network software.
  513.  
  514.        without whom none of this would have been necessary.
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.                                          7
  523.